Skip to content

JSON-LD structured data for skill listings#8

Open
VisionaireLabs wants to merge 1 commit into
masterfrom
feat/skill-jsonld
Open

JSON-LD structured data for skill listings#8
VisionaireLabs wants to merge 1 commit into
masterfrom
feat/skill-jsonld

Conversation

@VisionaireLabs

Copy link
Copy Markdown
Collaborator

Adds schema.org SoftwareApplication structured data (JSON-LD) to every skill detail page (/skills/[slug]) so search engines can surface rich results.

What

  • lib/jsonLd.tsskillJsonLd(skill) builds the markup purely from real lib/skills.ts catalog fields.
  • app/skills/[slug]/page.tsx — injects <script type="application/ld+json"> into the page.

Honesty (per repo rules)

  • No aggregateRating / review — we have no real ratings, so the block is deliberately absent (avoids Google penalizing fabricated review markup).
  • No install counts — schema has no honest field for them; not dressed up as a review signal.
  • offers emitted only when a real price exists (free → price 0; per-use/one-time → real USD amount). Unpriced skills get no offer.
  • license emitted only for real SPDX identifiers; undeclared/unknown/proprietary/source-available get none.
  • softwareVersion omitted for the 0.0.0 pre-release sentinel.
  • author typed Organization for first-party, Person otherwise.

Verification

  • tsc --noEmit clean, eslint clean on both files.
  • next build succeeds; all 277 skill pages prerender with valid JSON-LD.
  • Spot-checked emitted HTML: first-party (MIT, no offer), free skills.sh listing (free offer, undeclared license correctly omitted).

🤖 Generated with Claude Code

Emit schema.org SoftwareApplication structured data on each skill
detail page so search engines can surface rich results.

- lib/jsonLd.ts builds the markup from real catalog fields only
- No aggregateRating/review and no install counts — we have no honest
  source, so they are deliberately absent
- license emitted only for real SPDX ids; offers only when a real price
  exists (free/per-use/one-time); 0.0.0 pre-release version omitted

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: multica-agent <github@multica.ai>
@vercel

vercel Bot commented Jun 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
solidstate.cc Error Error Jun 3, 2026 10:25pm

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant